home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 039a / szml2src.zip / SIZEMAIL.DOC < prev    next >
Text File  |  1990-12-31  |  9KB  |  222 lines
  1. SIZEMAIL v2.00 - 12/31/90
  2. --------------------------------------------------------------------
  3. Keeps compressed mail bundles a reasonable size
  4. --------------------------------------------------------------------
  5.  
  6. SizeMail looks at your Binkley outbound holding area(s) and compares
  7. compressed  mail sizes to  the sizes  you  allow to  be sent to each
  8. node. If the size is larger than what is allowed, SizeMail will move
  9. the compressed mail bundle to a new location and  mark the bundle as
  10. 'deleteable' by Binkley.  It will then create a new 0 length file of
  11. the same name in the outbound area so that  oMMM/QMail will properly
  12. increment the filename extension on its next run.   The new location
  13. for   the   compressed   mail  will  be   in   a   directory   named 
  14. <path><outbound>.TMP  where <path> is an optional drive:path you can
  15. specify  for the hold area  and  <outbound> is the pathname you give
  16. SizeMail  for  your  standard  outbound directory.  If the specified
  17. hold directory does not exist, SizeMail will create it for you.
  18.  
  19. SizeMail reads in a file named SizeMail.Cfg for all of its work. 
  20. The file has three types of lines allowed:
  21.  
  22.    node <address>
  23.  
  24.     You are required to specify only one of these.
  25.  
  26.         This contains your full zone:net/node address so SizeMail
  27.     can determine the filenames to look for later in processing.
  28.  
  29.    outbound <directory>
  30.  
  31.     You are required to specify only one of these.
  32.  
  33.         This gives SizeMail the path\name to your normal outbound
  34.         directory.  Do NOT use a trailing backslash!  SizeMail will
  35.     assume the directory is used for mail to your zone, and it
  36.     will append the hex representation of the zone for mail to
  37.     other zones.  It will also expect to find a directory named
  38.     <directory>.TMP for use in holding oversized compressed mail
  39.     files. If this directory doesn't exist, it will be created
  40.     for you.
  41.  
  42.    size <address> <bytes> [<hold_directory>]
  43.  
  44.         You may specify up to 500 of these.
  45.  
  46.     Address is the complete zone:net/node address of the system
  47.         affected.  Bytes is the maximum number of bytes that should
  48.         be allowed to accumulate in a mail bundle for this system. 
  49.         If SizeMail detects a mail bundle larger than <bytes> in
  50.         size, it will move the bundle to <outbound>.TMP and mark it
  51.         as deleteable in the .FLO file for this system. If a hold
  52.     directory is specified for the node, then Sizemail will, if
  53.     necessary, create it and then move the mail bundle into that
  54.     hold directory. If a hold directory is not specified for
  55.     this node, Sizemail will assume that the hold directory will 
  56.     be created in the same drive:path as the outbound directory
  57.     and will use the default outbound name suffixed with ".TMP"
  58.     as the directory name. As above, DO NOT use a  trailing
  59.     backslash on these paths!    
  60.  
  61.  
  62. COMMAND LINE OPTIONS
  63. --------------------
  64.  
  65. When  executed, you may specify on the command line the path/name  of 
  66. the configuration file to be used in that run. A sample execution  of 
  67. this operation would be:
  68.  
  69.                      Sizemail -cc:\t\limit.cfg
  70.  
  71. If  a  configuration  file  is not specified  on  the  command  line, 
  72. Sizemail  expects  to  find  the file  Sizemail.Cfg  in  the  current 
  73. directory.
  74.  
  75. Sizemail also allows those of you running QM 1.23b to specify a flags 
  76. directory for the multiple session flag files to be kept in. If  this 
  77. option  is active Sizemail will check the flags directory for a  flag 
  78. file  for each node number before processing it. If it finds one  for 
  79. the  node number it is starting to process, processing for that  node 
  80. will  be skipped. This is to prevent Sizemail from trying to  move  a 
  81. file  while  the  mail  processor is still  updating  it  in  another 
  82. session. The flags area path may be specified with the "-f" option as 
  83. follows:
  84.  
  85.                      Sizemail -fc:\binkley\flags
  86.  
  87.  
  88. In  addition,  Sizemail has support for the BinkleyTerm  v2.40  style 
  89. *.BSY  flags.  This  addition will allow sizemail  to  co-exist  with 
  90. Binkley  running under DV without having collisions from both  trying 
  91. to  access  the  same  mail packet at  the  same  time.  The  Binkley 
  92. multitasker  option mode may be enabled with the "-b" option  on  the 
  93. command  line. Both Binkley and QM style multitasking may be  enabled 
  94. at the same time if necessary.
  95.  
  96. Sizemail  also  contains a command line option  to  suppress  routine 
  97. output to the screen. The verbose switch allows the user to specify a 
  98. level  of  output from 0 to 2. 0 is no output except for  warning  or 
  99. error messages, 1 is output only messages pertaining to nodes  having 
  100. mail which was processed, and 2 is output all messages for all  nodes 
  101. listed (useful for debugging). Warning and error messages will always 
  102. be  sent  to  the screen regardless of  verbose  level  enabled.  The 
  103. verbose  level  may be enabled with the "-vx" option on  the  command 
  104. line (x specifies the level number). Should the user not specify  the 
  105. verbose level, level 2 is assumed.
  106.  
  107. Sizemail  now has the provision of being able to move all  files  for 
  108. all  nodes specified in the *.cfg file through a command  line  flag. 
  109. This  flag overrides any thresholds specified in the *.cfg. The  move 
  110. all mode may be enabled with the "-a" option on the command line. 
  111.  
  112. Finally,  Sizemail contains a short script which may be  accessed  by 
  113. executing  it with a "?" on the command line. If found, the "?"  will 
  114. override any other options and display the help script.
  115.  
  116. It should be noted here that all Sizemail command line arguments  ARE 
  117. case significant!
  118.  
  119.  
  120.  
  121. A typical SizeMail.Cfg file:
  122. ----------------------------
  123.  
  124.    ; My node number
  125.    ;
  126.    node 1:132/101
  127.    ;
  128.    ; Use my standard outbound.. default hold directory will be
  129.    ;  C:\Bink\Outbound
  130.    ;  Notice no trailing backslash
  131.    ;
  132.    outbound C:\Bink\Outbound
  133.    ;
  134.    ; the following will move any bundles for 132/113 over 500k to
  135.    ;  D:\Outbound.Tmp
  136.    ;
  137.    size 1:132/113 500000 D:\Outbound
  138.    ;
  139.    ; the following will move any bundles for 132/119 over 250k to
  140.    ;  E:\Outbound.Tmp
  141.    ;
  142.    size 1:132/119 250000 E:\Outbound
  143.    ;
  144.    ; Node 1014/1 is at 2400 baud and has a noisy line, give him a
  145.    ;  chance to get his mail in small pieces.
  146.    ;  His mail will be moved to C:\Bink\Outbound.Tmp
  147.    ;
  148.    size 1:1014/1  50000
  149.    ;
  150.    ; If this ever gets this large, I know there is a problem since I
  151.    ;  only send about 5K per night!
  152.    ;
  153.    size 99:9000/1 15000
  154.  
  155.  
  156. SizeMail  should be used in your batch file(s) immediately  PRECEDING 
  157. any calls to oMMM.  For example:
  158.  
  159.    ConfMail Export ...        or            QM Toss Scan Pack ...
  160.    SizeMail                                 Sizemail
  161.    oMMM ...
  162.  
  163. This can be done within a loop using ConfMail to limit the number  of 
  164. outgoing  messages.  Done this way, SizeMail will do its thing,  even 
  165. in the middle of multiple runs of ConfMail. 
  166.  
  167.  
  168. BUG REPORTS
  169. -----------
  170.  
  171. If you experience a problem with Sizemail v2.00, please send as much
  172. information  as possible about it to Bill Weinel at  1:151/121.  Your 
  173. report  will  be  worked on as available time  permits.  Include  (if 
  174. possible) at least the following items:
  175.  
  176.  --  Your Sizemail control file.
  177.  --  The batch file you use to invoke Sizemail.
  178.  --  The packets and ?LO files (if any) it had problems with.
  179.  --  Both your Config.Sys and Autoexec.Bat files.
  180.  --  A full description of what happened.
  181.  
  182.  
  183. DISCLAIMER
  184. ----------
  185.  
  186. This program  is guaranteed to do absolutely nothing. Use it at  your 
  187. own risk. No  warranty is  stated  or  implied.  The  authors   shall  
  188. not   be responsible for  any  damages  resulting  from   it's   use,  
  189. directly  or indirectly.
  190.  
  191. This software  MUST be  distributed free  of charge. UNDER ABSOLUTELY 
  192. NO  CIRCUMSTANCES  MAY  IT  BE SOLD! Portions  of  this  program  are 
  193. copyrighted  and are the sole property of the authors. It may not  be 
  194. distributed  in a modified form without expressed written  permission 
  195. of the authors.
  196.  
  197. You may use the software only after agreeing upon the above terms.
  198.  
  199.  
  200. KUDOS
  201. -----
  202.  
  203. The original work  and documentation on this program was done by  Bob 
  204. Hartman.  This  version  contains  Bob's  original  work  with  added 
  205. features by Bill Weinel (1:151/121.0).
  206.  
  207. Consequently,  please send suggestions, bug reports, and comments  to 
  208. Bill Weinel at 1:151/121.0 and don't bother Bob.
  209.  
  210. I  would like to extend my appreciation to all those who have  helped 
  211. test  this  program  and  have  contributed  suggestions  inorder  to 
  212. facilitate  it's  improvement.  My special thanks  go  out  to  Amnon 
  213. Nissan, George Peace, John Souvestre, John Valentyn, and Bob  Hartman 
  214. all of whom were all brave enough to run the betas on their machines! 
  215. Also  to Dean Lachan who contributed the base code for the  QM  flags 
  216. option (thanks Dean!). And finally, once again to Bob Hartman,  whose 
  217. fine code inspired this programmer to try to give back to the Fidonet 
  218. community a better product than he received. I hope this program will 
  219. be of service to you all.  Bill.
  220.  
  221.  
  222.